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Pascal-2 V2.1D/RT-11 Release Notes 


The information contained in this document describes the Pascal-2 V2.1D release package. In these 
notes you will find: 

• A list of problems (“bugs”) we’ve fixed in this release. 

e Notes on changes in the documentation and on how to update the user manual. 

• Miscellaneous notes of interest to Pascal-2 users. 

• The Installation Guide. 

These release notes should be read before attempting to install the compiler and utilities on your 
system. The “Documentation Notes” section of the release notes should be read before attempting 
to insert the change pages from the update package into the user manual. 

Style Notes 

This document follows these style conventions: 

Text: 

Pascal reserved words, predefined symbols, switches and compiler directives are in boldface 
typewriter: begin, Trite, (include, noaaln. Portions of examples referred to in the 
text appear in boldface typewriter (the type style used in examples). Program, system 
and file names are in upper-case letters in the same type style as the text: SAMPL, 
VMS, SAMPL.PAS. 

Program Examples: 

Commands that you should enter are in underlined boldface typewriter: RP1 El. These 
commands assume a carriage return at the end. 

Program Listings: 

The Pascal-2 compiler accepts any combination of upper-case and lower-case characters. 
Examples in this manual have Pascal words in lower case and have user-defined words 
with an initial capital letter and other capitalisation as needed for readability, as shown 
in this program fragment: 

procedure Show; 
begin 

SoneUseriction; 
uritela(Result); 

•ad; 


Terminology: 

We use standard terms as they are used in documents describing the RT-11 operating 
system. 
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Changes in the Software 

Version 2.ID is primarily a maintenance up-date; changes in software between Versions 2.ID and 
2.1C consist for the most part of fixes for previously known problems. 


Problems We’ve Fixed 

Version 2.ID corrects the following problems: 

Record field as a parameter 

The compiler generated bad code when certain nested record fields were passed as a parameter. 
Negative stack ofibet for common subexpressions 

Depending upon the location of a variable’s declaration, two identical calculations involving certain 
functions, including sin and con, could have different results. The library routines for the functions 
caused the compiler to reference a negative offset from the stack pointer. 

Wrong results from integer comparison 

A comparison between an integer and a subrange that is an element of a packed record produced 
an incorrect result. 

Incorrectly addressed real variable 

Certain globally allocated real variables were incorrectly addressed. As a work-around, reducing the 
size of the program seems to remove the error. 

Dynamic string package errors 

The Insert routine printed the error message Array subscript out of bounds when the com¬ 
bined length of the two input strings exceeded the target string’s length. Now, the insert string is 
concatentated onto the end of the target string and truncated. 

The Concatenate routine reported errors when the string to be concatenated overflowed the target 
string. The input string is now truncated to fit. 

2SPage directive didn’t work 

On listings, Ipage incremented the page number incorrectly. 

Reserved Instruction trap error 

Using a packed record containing integers in a nested procedure call caused a reserved instruction 
trap. 

Illegal instruction gave "compiler writer error" 

Using certain illegal instructions resulted in the error message for internal problems instead of the 
appropriate error message. 

No error message 

The compiler failed to give an error message for attempts to pass an element of a packed structure 
as a variable-parameter. 
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Problems We*ve Fixed 


The compiler Incorrectly need RO for procedure caDe 

The compiler failed to save the contents of the BO register after noapaecal procedure calls. 

Memory protection violation 

A memory protection violation occurred in isolated instances when the value of BO was not initialized 
before adding the offset. 

Sets generated bad code 

Set constructor expressions of the form [varl..var2] generated bad code at times. 

Set type produces wrong results 

The declaration and statement 

typo a * set of (one,two,three); 
var b:a; 

e 

begin 

b:* [one,three]; 
write (b • []<*[]); 

end. 

produced a set of 256 items merged with a set of 3 results. 

Function returns Incorrect result 

The compiler incorrectly changed bit lenghts to byte lengths when a function returned a structured 
type. 

Bit optimisations Incorrect 

Compiler optimization of certain user-defined procedure calls produced an incorrect sequence of 
execution. 

PB formatter rejects "nonpascal" 

The formatter failed to recognize the nonpascal directive. It now treats nonpascal exactly like the 
external directive. 

String comparison range wrong 

For string comparisons, ord(char) was in the range 0. .255 instead of -128.. 127. The range is now 
correct. 

Unsigned characters treated as signed 

The compiler treated 8-bit characters as if they were signed numbers when the character was 
optimized. 

Assignment statements caused failure 

A complicated series of assignment statements involving arrays of type real previously failed. 

Compiler consistency checks reported 

Certain instances of undeleted tenps in procedure. .. were fixed in 2.1D. 
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Llnka|« failure during Installation 

A missing continuation character in the file UTILS.XM, which builds the utilities, caused a failure 
at the point where XREF is linked. 

Misleading error message for nonexistent flies 

The compiler printed the error message “Unknown Pascal run-time error” for an attempt to compile 
a nonexistent file or a file containing a {include of a nonexistent file. 

Debugger overlays do not work for XM monitor systems 

XMDBG.COM, the XM monitor command file that links Debugger modules with a Pascal program, 
now correctly overlays Debugger modules. 

# 
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Documentation Notes 

The documentation for Pascal-2 Versioa 2.1D include* the second edition of the Pssest-2 User 
Manual, which documents the enhanced V2.1 software, and Update Package No. 2, documenting the 
2. ID features. (Update Package No. 1 was previously distributed and all changes then noted have 
been incorporated into the manual.) We have expanded a number of sections, including ‘External 
Modules,” “Resident and Cluster Libraries,” and “The Debugger Guide.” The expanded sections 
provide new information and clarify and correct earlier material, at user suggestion. Update Package 
No. 2, records these changes and is made up of “change pages” for insertion into the user manual 
at the appropriate place. The update package’s cover sheet should be inserted into the manual just 
before the first contents page, to keep a history of changes to the manual. 

The Release Notes, containing the Installation Guide, is a companion document of the Pssest-2 User 
Manus/ and should be kept with that manual for reference. 


Miscellaneous Notes 


Official ISO Standard for Pascal 

The Pascal language now officially has an international standard. The International Standards 
Organization, in a vote tallied this summer, adopted a standard language definition for Pascal. The 
action followed earlier adoption of an American standard that is a subset of the international one, 
lacking only conformant array parameters. 

The sequence leading to adoption of the Pascal standard began in December 1982, when ANSI and 
IEEE agreed on the American standard, identical to the international draft standard except for 
conformant array parameters. At the same time, the Joint Pascal Committee of ANSI and IEEF. 
recommended adoption of the international standard Level 1 (including conformant array parame¬ 
ters) to the U.S. committee known as X3J9, which then voted “yes” on the international standard 
at the next meeting. Previously, the U.S. was one of three “no” votes. This time, the ISO standard 
passed with no dissenting votes and one abstention. 

Peppered throughout the Language Specification of the user manual are references to the “draft” 
standard. The word “draft” can be ignored. (Change pages were not issued for this change.) 

Packing Problems 

Several users have uncovered bugs in Pascal-2’8 packing of records and arrays. We believe that it 
may be necessary to modify the packing algorithm slightly in version 2. IE in order to correct these 
problems. If such a change is necessary, users who have programs that involve the reading and 
writing of packed records or arrays may have to convert their data files to the new format in order 
to use V2.1E. This new version will be released in roughly six months; if the packing conversion 
is necessary we will make every effort to clearly document when and how to follow the conversion 
process. 

Stack Overflown 

Especially large stack overflows, those that extend beyond the heap and into the program code 
sections of memory, have the potential for causing serious problems. In some cases it is possible for 
the error to prevent the appropriate error message from being printed or the program from properly 
terminating. In some rare instances, the condition can even lead to the disruption of the computer’s 
operating system. It is the programmer's responsibility to avoid such excessively large overflows by 
controlling the size of local variables and value parameters passed to procedures. 


s 
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Notes 




EXITST Creates a Walk back for ‘Severe Error' Status (4) 

The Exltet procedure is a support library routine that sets the termination status of a program 
and stops the program when a "severe error* status is detected. The procedure’s integer argument 
determines the termination status for any program that calls it. When a "severe error” status of 4 
is passed, the procedure also invokes the post mortem analyzer to create a walkback of the program 
execution from the point of failure. 







Pascal-2 V2.1D/RT-11 Installation Guide 


This guide describes the way to load the RT-11 Pascal-2 software on your system. The V2.1 software 
runs on RT-11 V4 and V5. 

To install Pascal-2 V2.1 for RT-11, follow the steps below: 

1. Copy all of the Pascal-2 files to the system device (ST:); 

2. Select a compiler depending on yonr system monitor; 

3. Select a run-time library depending on yonr processor hardware options; 

4. Compile the Pascal-2 utility programs; 

5. Set the compiler’s listing file page site to a value other than 60 octal (optional); 

6. Extract the Debugger modules from the support library for use in overlaying the Debugger 
against user programs. 

7. Delete files no longer needed (optional). See Appendix B for a sample deletion command. 

These steps are described in detail in the following paragraphs, and are illustrated by an example 
that can be found in Appendix B of thi3 guide. The installer should read this guide in its entirety 
before attempting to install the software. Upon successful completion of the installation, the Pascal-2 
system is fully operational as described in the Pssesl-2 User Manual. 

This guide contains two appendices. Appendix A lists the files contained in the release media. 
Appendix B shows a typical XM installation. 


Copying the Pascal-2 Files to the System Device 

Copy all of the distribution files to the system device (ST:) using the ASSICI and COPT commands, 
as shown below: 

• ASSIQI 5T PI -- assigns ST: as default device 

• CQfT. MIO; ST; -copies magtape to system device 

If your system disk is a floppy disk, or is otherwise limited in available space, you should first read 
the following sections and select the files that are necessary for your system. Then copy those files 
to your system. The minimal system requires one compiler file and one library file. You may wish to 
build more than one system disk and, for example, install the compiler, library, and Debugger on 
one disk and the utility programs on a second system disk. 


Selecting a Compiler for Your System Monitor 

There are two compilers supplied with Pascal-2. Your choice of a compiler depends on the version 
of the RT-11 monitor you intend to use. There are four possibilities: the Base-Line (BL) monitor, 
the Single-Job (SJ) monitor, the Foreground-Background (FB) monitor, and the eXtended-Memory 
(XM) monitor. 

If you are using either the BL or the S J monitor, choose the compiler called SJ.SAV. If you use the 
XM monitor, select the compiler called XM.SAV. 

The FB monitor does not leave sufficient memory to run the Pascal-2 compiler. If you are using 
the FB monitor, you must switch to either the SJ or XM monitor (using the BOOT command) before 
compiling a Pascal program. Once compiled, programs may be linked and run under the FB monitor. 
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The XM compiler should be chosen over the S J compiler where possible because it uses the extended 
memory or “virtual” overlay capability and gives faster compilations. 

When you have selected a compiler file, copy it to ST:PASCAL.SAT with the following command, 
which assumes the default device is ST:. 

COPT SJ.SAT PASCAL.SAT -installs SJ compiler 

or: 

COPT IM.SAT PASCAL.SAT -installs XM compiler 

You may then delete S J.SAV and XM.SAV, or you may leave them on your system disk for use under 
their respective monitors. (See Appendix B.) 


Selecting a Run-Time Library 

There are four run-time libraries supplied with Pascal-2, one for each combination of processor 
instruction sets. Choose the library that matches the configuration of the processor that will run 
your compiled programs. 

The possible configurations are: 

e FPP — a processor with the Floating Point Processor instruction set. The FPP is standard 
equipment on the PDP-11/60 and optional on all new PDP-ll’s and the LSI-11/23. If your 
processor includes the FPP, select the LIBFPP.OBJ library. 

• FIS — the Floating Instruction Set. The FIS hardware is an option available for the LSI-11, 
LSI-11/2 and some older PDP-11 processors. If your processor has FIS, select the LIBFIS.OBJ 
library. 

• EIS — Extended Instruction Set, for hardware support of multiply, divide, and long shift 
instructions. EIS is standard equipment on all new PDP-11 and LSI-11/23 processors and an 
option available for all older LSI-1 l’s and PDP-U’s. If your processor has neither FPP nor FIS, 
but does have EIS, then select the LIBEIS.OBJ library. 

e For processors with no extended or floating instructions, select the LIBSIM.OBJ library. This 
library operates on any LSI-11 or PDP-11 regardless of its actual configuration, but does not 
take advantage of any optional hardware. 

After selecting a library file, copy it to ST:PASCAL.OBJ with the following command or one similar 
to it, depending on the processor configuration. In the command, ST: is the default device. 

COPT LIBFPP.OBJ PASCAL.OBI -FPP library 

You may then remove the other library files, or leave them on the system for use with other 
configurations. (See Appendix B.) 


Compiling the Utility Programs 

Five Pascal-2 utility programs are supplied in source form and are automatically compiled and linked 
by one of two command files, UTELS.S J and UTILS.XM. UTILS.S J prepares the utility programs for 
execution under the SJ, FB and BL monitors; UTILS.XM prepares them for execution under XM. 
Feel free to examine these command files before executing it indirectly using one of two commands: 

.WIILSuSJL 

or: 

.WIILS,at 
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Compiling tb« Utility Programs 


Upos completion of UTILS, the utility programs are available for use as described in the Utilities 
Guide of the Paacal-2 User Manual. 

In UTILS JCM ail of the utilities must be linked as “virtual jobs” made up of virtual overlays because 
their load images are larger than 16K. (The XM monitor can not load a program with a root segment 
larger than 16K.) The Pascal-2 file START.OBJ is used in the link process to create a null root 
segment, tricking the Linker into loading the oversued program. The Pascal-2 User Mutual contains 
a detailed description of this technique for user programs in Pascal. 

When UTILS completes, you may then delete the extra .OBJ and .MAP files left on the disk by the 
UTILS command file. (See Appendix B.) 


Setting the Page Size of the Compiler’s Listing File 

The command files RTPAGE.COM and XMPAGE.COM, supplied with the Pascal-2 release, provide 
a means for changing the number of lines per page of the SJ and XM compilers' listing file, 
respectively. This feature allows for the use of odd-sixed printer paper or for special printing needs. 

Before executing either command file, you must modify the lines-per-page value in the fifth line of 
data in the command file. (The first line of data is the file to patch.) The normal page sixe (in octal) 
is 66, not counting header lines. 

I Conaaad file to patch tho SJ version of Pascal to change 
I the liaee per page of a listing file 
I 

! Change the nuaber nn (octal) to another value, la octal 
f that represents the ■saber of linee per page of a listing file 

1 that you require. 

! 

R SIPP 
ST:PASCAL 

3075 

2 

na ---lines per page 

*T 

*C 

where ns is the desired page size in octal. The value ‘3075’ is the base address of the symbol PAGELI, 
and the actual value in the supplied command filemay be different. The value *2’ is the byte offset 
from the base address of the location to patch. Values for the page sixe and byte offset must not be 
changed. 

After editing the appropriate file, execute it indirectly with the command: 

AHTPAGE -for SJ installation 

or: 

stmmce - for XM installation 
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Extracting Support Library Modules for Debugger Overlays 

Before users can overlay the Debugger against their programs, the command file EXTRAC.COM 
must be executed. This command file, supplied with the release kit, extracts from the Pascal support 
library the Debugger and other key modules used by the XMDBG.COM (for XM systems) and 
SJDBG.COM (for SJ systems) command files, also in the release kit. (Users can then execute either 
XMDBG.COM or SJDBG.COM to overlay the Debugger and their Pascal programs.) EXTRAC.COM 
places the modules onto the system device (ST:), with the extension .DBG. It need only be executed 
once. 

The command file can be executed with the indirect (at-sign) processor, as shown: 

•Erntic 


Installing Pascal-2 With Pascal-1 

The Pascal-1 system compiler can be renamed to allow simultaneous use of Pascal-1 and Pascal-2. 
Then, the files for both systems can be present on the system device without conflict, provided that 
the compiler/library versions and upgrade levels are themselves compatible. (For example, Pascal-1 
V1.2K is compatible with Pascal-2 V2.0K, and V1.3C is compatible with V2.1C; V1.2K, however, 
is not compatible with V1.3C. 

The object library PASCAL.OBJ can be shared by the two systems (as long as the two system 
versions are compatible); the libraries supplied with Pascal-2 include all of the Pascal-1 routines. 
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Appendix A: Distribution Files 


Compilers 

SJ . SAT Pu<il-2 Compiler for SJ monitor 

XM . SAT Pascal-2 Compiler for XM monitor 


Object Librnries 

LIBFPP. OBJ Library for processors with FPP and EIS 
LIBFIS.OBJ Library for processors with FIS and EIS 
LIBEIS .OBJ Library for processors with EIS only 
LIBSH.0BJ Library for base-level processors 
TIBJOB. OBJ Header module for XM virtual jobs 
STABT . OBJ Null root module for XM virtual overlays 


Command Files 

EXTBAC.COM 
SJDB8 .COM 
XMDBQ .COX 
BTFA6E.COM 
XMPA6E.COM 
UTILS .SJ 
UTILS .XM 

Utility Programs 

PASXAT.PAS 
PB .PAS 
XBEP .PAS 
PBOCBE.PAS 
PBOSE .PAS 
STBISC.PAS 
PASMAC.MAC 
SATEBB.PAS 
UEBBOB.PAS 
0PEBB0.PAS 
LIBDEF.PAS 
CSITTP.PAS 
CSIPBO.PAS 
FIXAB6.PAS 
FIXIBC.PAS 
FIXOUT.PAS 
STMDCL.PAS 
STMCOD .PAS 
CITIUM.PAS 


Support library module extractor for Debugger overlays 

Debugger overlayer for SJ monitor 

Debugger overlayer for XM monitor 

SJ listing-file page size patcher 

XM listing-file page size patcher 

SJ, FB and BL utility installer 

XM utility installer 


Program formatter 
Pascal Beautifier 
Cross-referencer 
Procedure cross-referencer 
Text formatter 
String package 

MACRO-11 interface package 
System error message printer 
User error reporting module 
Support library error routine 
Support library definitions 

Command String Interpreter (CSI) type definitions 

CSI procedure definitons 

CSI argument parser 

CSI {include file handler 

CSI temporary output manager 

CSI symbol table declarations 

CSI symbol table manager 

CSI command-line number converter 


Demonstration Programs 

* Vary from release to release 
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Appendix B: Typical XM Installation 


The following steps illustrate the installation of Pascal-2 from magtape on a processor that includes 
the FPP floating point processor. The Pascal-2 compiler for the extended memory (XM) monitor is 
selected. 


•ASSISI ST PI - 

COPT MTO: ST: 

COPT LIBFPP.OBJ PASCAL.OBJ 

■COPT Ml,SAT PASCAL,SAT - 

•OTILS.XM - 

R PASCAL - 

PASMAT/TIME/VORIS7ACE=6SO 


assigns ST: as the default device 

-selects the FPP library 

-selects the XM compiler 

-builds the utilities 

-builds PASMAT 


I Tho folloviig link will round up tko root to 4K mad put tho extra 
I aoaory oa tho heap 
R LIRE 

PASKAT.PASMAT»START,TIRJOB/D:30000// 

PASMAT.PASCAL/T:1 

// 

PIGROV 

*C 

R PASCAL -builds PB 

PR/TIME 
R Lin 

PB.PB=STRAT.TIBJOB/O:20000// 

PB,PASCAL 

//PIGROV 

*C 

R PASCAL -builds XREF 

XREF/TIME 

r Lin 

XREF=STABT.TIRJOB/O:20000// 

XREF,PASCAL/Y:1 

// 

PIGROV 


*C 

R PASCAL -builds PROCREF 

PROCRE/TIME 
R LIU 

PROCRE.PROCRE=START.TIBJOB/D:20000// 

PROCREF,PASCAL/T:1 

// 

PIGROV 

*C 

R PASCAL -builds PROSE 

PBOSE/TIME/IORKSPACE=700 
r Lin 

PROSE,PROSEsSTABT,TIRJOB/O:20000// 

PROSE.PASCAL/T:1 

// 


PIGROV 

*C 


Install -0 





















Appendix Bt Typical XM Installation 



UttAfil -»<t» listing page sue to value other than 66 octal (optional) 

.IQQIS, extracts library modules for Debugger overlaying 

. B PIP -cleans up the system disk (optional) 

«S J. SAT.m.SAT/D - Remove the compilers, leaving PASCAL.SAV 

<LIBFfP, OBJ. HBflS. OBJ. LIBEIS. QB1 J.IBSI1. OBJ/P 

• PASMAT.OBJ.PB.OBJ.IRET.OBJ.PBOCBE.OBJ.THOSE.OBJ/D 

♦ PASMAT.MAP.PB .MAP.IBEP.MA P.PBQCBE.MAP.THOSE.MAP/D 

•IS 
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